home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / facts28.zip / FACTS.DOC < prev    next >
Text File  |  1992-09-23  |  15KB  |  341 lines
  1.  
  2.                                    FACTS 2.8
  3.                                    =========
  4.  
  5.          One of The Livewire BBS PCBoard(TM) multi-BBS Doorware programs.
  6.                   Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS,
  7.                     Remote Access, SpitFire, WWIV and others.
  8.  
  9.                                       By
  10.  
  11.                                 Richard Paquette
  12.                                    PO Box 416
  13.                               Mt. Laurel, NJ 08054
  14.  
  15.                                (C) Copyright 1990
  16.                                All Rights Reserved
  17.  
  18.                  DOOR DESCRIPTION!
  19.  
  20.    If you have ever watched Jeopardy on television, then you will have a very
  21. good idea what FACTS is all about.. when you first enter the door, the main
  22. menu allows you:
  23.  
  24.                         1. Play the GAME OF FACTS    
  25.                         2. Get Instructions/Help
  26.                         3. View Scoreboard
  27.                         4. Color On/Off
  28.                         Q. Return to BBS
  29.  
  30.    1. Play the GAME OF FACTS brings you to a full page category menu with the
  31.  categories listed across the top line. When you select a category number, it
  32.  then prompts for the amount to win which are listed vertically. After you have
  33.  selected the amount, the answer is displayed with a prompt for the question.
  34.  
  35.       You enter the question, if correct, then you score is updated with the
  36.  amount you selected, if wrong, no score is given nor is the amount taken from
  37.  your current score.
  38.  
  39.       If you play all 25 questions, you are then automatically brought to the
  40.  BONUS ROUND at which time you will be prompted to BET on the question. Your
  41.  bet can be anything from $1.00 to your TOTAL SCORE. If you win, you double
  42.  your bet and if you lose, you lose only your bet.
  43.  
  44.       You are then brought to the main menu and cannot play again unless you
  45.  exit the door and re-enter it if your time online has more than 5 minutes
  46.  left. If not.. then you won't be allowed back in.
  47.  
  48.    2. Get Instructions is similiar to these descriptions.
  49.  
  50.    3. View Scoreboard will list your name according to the highest score first
  51.  and descending from there.
  52.  
  53.    4. Color On/Off allows you to toggle your color on or off.
  54.  
  55.    5. Returns you to the BBS.
  56.  
  57.                                       FILES
  58.  
  59.            The following files are packaged with this ZIP file
  60.  
  61.  Facts.exe   <--- executable program must be in directory at all times
  62.  Facts.cfg   <--- sample configuration file, must have one for each node
  63.  Categor.eis <--- this file contains names of the categories in the directory
  64.  science.dat <--- one question and answer file, must be in directory
  65.  flowers.dat <--- another question and answer file, must be in directory
  66.  cities.dat  <--- another question and answer file, must be in directory
  67.  capital.dat <--- another question and answer file, must be in directory
  68.  movies.dat  <--- another question and answer file, must be in directory
  69.  facts.usr   <--- created by program and MUST NOT BE DELETED
  70.                   (this maintains the players names and scores)
  71.  order.frm   <--- Order form for all Livewire Doors
  72.  facts.log   <--- Will create if not present.. tracks callers in door
  73.  
  74.  Categor.eis contains all the current categories in your directory that are
  75. randomly selected and place in the game.. the more you have the better it is.
  76.  
  77.  Each time someone opens the door, there will be different categories to get
  78. selected and the program takes care of all the work for you. Please read the
  79. important note to find out more...
  80.  
  81.   IMPORTANT NOTE:
  82.  
  83.   When this door is registered, you may download other *.dat files and add them
  84. to your categor.eis file with the facts utility now being finished. Each of the
  85. *.dat files has 50 questions and the questions are randomly selected so that
  86. 90% of the time, the same question will not appear twice in the same category
  87. within the 5 dollar amounts.
  88.   
  89.   Of course by registrating this door, you will have access to all the new
  90. *.dat files being created and you will recieve an editor to add questions to
  91. the existing *.dat files and also add new categories along with editing the
  92. facts.usr file.
  93.  
  94.   The Editor and other dat files are downloadable from The Livewire BBS, home
  95. of FACTS.ZIP plus many other fine door products.
  96.  
  97.   Other files already to go include subjects such as: 
  98.  
  99.   History, General, Flowers, Trees, Capitals, Cities, Trekie, Science plus many
  100. more under construction, the initial file contains only 50 questions which you
  101. can add to with your facts editing program.
  102.  
  103.   Please be sure to register as soon as possible.. will ease your conscious and
  104. allow you to have unlimited categories.
  105.  
  106.  
  107. CONFIGURATION
  108. -------------
  109.  
  110.   The registration number goes on line number 5 
  111.   The option to reveal answers goes on line number 6              Y=yes N=no
  112.   The option to create a log file (facts.log) on line number 7    Y=yes N=no
  113.  
  114.   NOTE: Leaving the lines (5-6-7) blank WILL create an error... 
  115.  
  116.  
  117.  
  118.  
  119.   The following are just samples for different softwares...
  120.  
  121.         EXAMPLE CONFIGURATION FILE FOR PCBOARD.SYS
  122.         ------------------------------------------
  123.  
  124.         C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  125.         The Livewire BBS    <=-  (Change this to your BBS name)
  126.         Richard             <=-  (The Sysop's first name)
  127.         Paquette            <=-  (The Sysop's last name)
  128.  
  129.         EXAMPLE CONFIGURATION FILE FOR USERS.SYS
  130.         ------------------------------------------
  131.  
  132.         C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  133.         The Livewire BBS    <=-  (Change this to your BBS name)
  134.         Richard             <=-  (The Sysop's first name)
  135.         Paquette            <=-  (The Sysop's last name)
  136.  
  137.         EXAMPLE CONFIGURATION FILE FOR NEW WILDCAT 3.0
  138.         ------------------------------------------
  139.  
  140.         C:\CAT\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  141.         The Livewire BBS    <=-  (Change this to your BBS name)
  142.         Richard             <=-  (The Sysop's first name)
  143.         Paquette            <=-  (The Sysop's last name)
  144.  
  145.         EXAMPLE CONFIGURATION FILE FOR DOOR.SYS
  146.         ---------------------------------------
  147.  
  148.         C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  149.         The Livewire BBS    <=-  (Change this to your BBS name)
  150.         Richard             <=-  (The Sysop's first name)
  151.         Paquette            <=-  (The Sysop's last name)
  152.  
  153.         EXAMPLE CONFIGURATION FILE FOR CALLINFO.BBS
  154.         -------------------------------------------
  155.  
  156.         C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  157.         The Livewire BBS    <=-  (Change this to your BBS name)
  158.         Richard             <=-  (The Sysop's first name)
  159.         Paquette            <=-  (The Sysop's last name)
  160.  
  161.         EXAMPLE CONFIGURATION FILE FOR DORINFOx.DEF
  162.         -------------------------------------------
  163.  
  164.         C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  165.                                   where 'x' is the BBS Node number.
  166.         The Livewire BBS    <=-  (Change this to your BBS name)
  167.         Richard             <=-  (The Sysop's first name)
  168.         Paquette            <=-  (The Sysop's last name)
  169.  
  170.         EXAMPLE CONFIGURATION FILE FOR SFDOORS.DAT
  171.         ------------------------------------------
  172.  
  173.         C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  174.         The Livewire BBS    <=-  (Change this to your BBS name)
  175.         Richard             <=-  (The Sysop's first name)
  176.         Paquette            <=-  (The Sysop's last name)
  177.  
  178.         EXAMPLE CONFIGURATION FILE FOR CHAIN.TXT
  179.         ----------------------------------------
  180.  
  181.         C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  182.         The Livewire BBS    <=-  (Change this to your BBS name)
  183.         Richard             <=-  (The Sysop's first name)
  184.         Paquette            <=-  (The Sysop's last name)
  185.  
  186.                                  ==============
  187.  
  188.                                 FACTS BATCH FILE
  189.  
  190. This is the batch file whose name is entered in PCBSETUP. It should reside in
  191. your default PCB directory. Leave this as is except for changing the paths.
  192.  
  193.           ECHO OFF
  194.           E:
  195.           CD\FACTS
  196.           FACTS FACTS.CFG  <--- Please read NOTE below
  197.           C:
  198.           CD\PCB
  199.           BOARD
  200.  
  201.   NOTE: FACTS requires the presence of BRT71EFR.EXE either in the
  202.         same directory as FACTS or accessible via PATH. If you set
  203.         your library in autoexec.bat and all the brun files there,
  204.         then you have no problems.. 
  205.  
  206.         SET MYLIB = C:\MYLIB
  207.  
  208.         Be sure to put all your brun*.exe files in the mylib directory!
  209.  
  210.  
  211. IMPORTANT NOTE FOR NON STANDARD IRQ's:
  212.  
  213.                   Supports COM 1 to 4 on the standard IRQ's
  214.                     Com1/Com3 = IRQ4 and Com2/Com4 = IRQ3
  215.  
  216.                You can make use of the IRQ environment variable
  217.  
  218.     If you wish to use a non-standard IRQ, add the IRQ number after the 
  219. configuration filename. For example the program is STORE and you want to use 
  220. Com1 and IRQ5. The command line passed to your door would be:
  221.  
  222.                             STORE STORE.CFG /5 
  223.                                    or
  224.              STORE STORE.CFG /%IRQ% using the environment variable
  225.  
  226.     The /5 tells STORE to use IRQ5 rather than the standard IRQ4 that is
  227. normally used with COM1. No /x parameter is needed for the standard IRQ's.
  228.  
  229.    You can also make use of the PCBoard environment variables such as:
  230.  PCBDRIVE and PCBDIR. Or you can use your own for example, let's say that
  231.  your system runs on D: drive and your system directory is call GAP then
  232.  you could use the variables at the start of your batch file such as:
  233.  
  234.    d:\
  235.    cd\doors\facts
  236.    set pcbdrive=d:
  237.    set pcbdir=\gap
  238.    facts facts.cfg
  239.    set pcbdrive =
  240.    set pcbdir =
  241.    d:\
  242.    cd\gap
  243.    gap
  244.  
  245.  Then the first line in your cfg would look like this:
  246.  
  247.                         %PCBDRIVE%%PCBDIR\dorinfo.def
  248.  
  249.                      ------------------------------------
  250.  
  251.                                 DOOR OPERATION
  252.                                 --------------
  253.   
  254.   F3    -   Toggles the printer On/Off.
  255.             Value is passed to PCBoard.
  256.   F4    -   Toggles the Page Bell On/Off.
  257.             Value is passed to PCBoard.
  258.   F5    -   DOS Shell.  Allows SysOp to exit to DOS from inside a DOOR.
  259.   F7    -   Toggles the Caller Alarm On/Off.
  260.             Value is passed to PCBoard.
  261.   F8    -   Returns the caller involuntarily to PCBoard.
  262.             Without letting them know that the sysop called them back!
  263.   F9    -   Toggles the local display On/Off.
  264.             Value is passed to PCBoard.
  265.   F10   -   Activates SysOp CHAT mode within the DOOR.
  266.  
  267.   ESC   -   Deactivates CHAT mode.  DOOR is resumed.
  268.   HOME  -   HELP key for status line options.
  269.   UP    -   Allows the SysOp to temporarily give the caller extra time
  270.             while in the DOOR.  This time is NOT passed to PCBoard.
  271.   DN    -   Allows the SysOp to temporarily subtract time from the
  272.             caller while in the DOOR.  This time is NOT passed to PCBoard.
  273.   ALT-N -   SysOp next on toggle.
  274.             Value is passed to PCBoard.
  275.   ALT-X -   PCBoard will exit after current caller logs off.
  276.             Value is passed to PCBoard.
  277.  
  278.                             WATCHDOG/CTTY/ANSI.SYS
  279.                             ----------------------
  280.  
  281.         CTTY and WATCHDOG are not required and should not be used with
  282.         this program.  FACTS contains its own communication routines
  283.         which monitor the COM port.  If carrier is lost, it will return
  284.         to PCBoard where the BBS will log the user off the system.
  285.         ANSI.SYS, or something similar, is required for FACTS to
  286.         function properly!
  287.  
  288.                                  DISTRIBUTION
  289.                                  ------------
  290.  
  291.         FACTS is COPYRIGHTED by Richard Paquette, with all rights reserved.
  292.         This program is being distributed via the SHAREWARE concept and as
  293.         such, may be copied freely with the following restrictions:
  294.  
  295.                 * The program must be supplied in it's original
  296.                   unmodified form, including documentation.
  297.  
  298.                 * FACTS may not be distributed as part of any
  299.                   commercial application or service without the
  300.                   express, written consent of the author.
  301.  
  302.                 * Vendors of Shareware/Public Domain software may
  303.                   not distribute this program without the express,
  304.                   written consent of the author.
  305.  
  306.                                  REGISTRATION
  307.                                  ------------
  308.  
  309.         FACTS represents many hours of programming and the author
  310.         deserves just compensation for his time, efforts and expertise.
  311.         If you find this program to be of some value and you continue
  312.         to use it on your BBS system, you must return the registration
  313.         form provided along with the registration fee. Registration
  314.         entitles you to free upgrades via modem from The Livewire's Support
  315.  
  316.         Additional upgrades/support to the BBS are available at $35.00 per
  317.         year. Payments should be made in the form of a check or money order
  318.         (do NOT send cash!). Foreign orders must be in U.S. funds drawn on a
  319.         U.S. bank.
  320.  
  321.            **********           REGISTER ONLINE          ***********
  322.  
  323.         You may also call The Livewire BBS and register online via
  324.         Visa or Mastercard using our online Credit Card door which will 
  325.         produce your registration number on the spot! At the main board
  326.         prompt just type  REGISTER  and presto.. 
  327.  
  328.         Suggestions and/or comments may be sent to the address below or
  329.         via electronic mail: 
  330.  
  331.                   HUBSNJ for RelayNet and Node ID is: LIVEWIRE
  332.  
  333.                                 Richard Paquette
  334.                                 The Livewire BBS     
  335.                            NET-HUB for RealLife(tm) Net
  336.  
  337.           Public Access Node1: (609) 235-5297 MNP/5 - 300/1200/2400
  338.           Free Access to D/S Nodes after registering a door program.
  339.                             ----------------------
  340.      High Speed Access for Door Registrations ONLY 609-866-2551 USRobotics DS
  341.